home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1m / arrayd.z / arrayd
Encoding:
Text File  |  2002-10-03  |  10.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaarrrrrrrraaaayyyydddd((((1111mmmm))))                                                          aaaarrrrrrrraaaayyyydddd((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      arrayd - array services daemon
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaarrrrrrrraaaayyyydddd [_o_p_t_i_o_n_s]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _a_r_r_a_y_d is the array services daemon.  It performs several different tasks
  16.      related to the use of an array of two or more machines, such as:
  17.  
  18.      - Allocating global array session handles
  19.  
  20.      - Forwarding "array commands" to all of the machines in an array
  21.  
  22.      - Maintaining a database of the current array configuration and providing
  23.        that information to other commands and programs
  24.  
  25.      - Determining which processes belong to a particular array session and
  26.        providing that information to other commands and programs
  27.  
  28.      For more discussion of these services, see _a_r_r_a_y__s_e_r_v_i_c_e_s(5).
  29.  
  30.      The _a_r_r_a_y_d command itself has several command line options.  The valid
  31.      options include:
  32.  
  33.      _----_cccc     "Check": causes arrayd to read any configuration files then exit
  34.             immediately, sending any errors to stderr rather than syslog
  35.             (which is the usual behavior).  This is primarily of use for
  36.             checking the validity of new configuration files.  This is the
  37.             same as the _----_qqqq_ffff flag.
  38.  
  39.      _----_ffff _f_i_l_e_n_a_m_e
  40.             Specifies the name of a single configuration file.  This option
  41.             may be specified more than once, in which case the files will be
  42.             processed in the order that they are specified.  One reason to
  43.             have multiple configuration files would be to allow all of the
  44.             machines in an array to use a single file (accessed via NFS,
  45.             perhaps) for array entries and still maintain private
  46.             configuration files for local options and/or security information.
  47.             The format of an arrayd configuration file is described in
  48.             _a_r_r_a_y_d._c_o_n_f(4).  If no configuration files are specified, then
  49.             "/usr/lib/array/arrayd.conf" and "/usr/lib/array/arrayd.auth" will
  50.             both be used (in that order).
  51.  
  52.      _----_mmmm _n_u_m_b_e_r
  53.             Sets the "machine identifier" used by the array services daemon
  54.             for generating global array session handles to _n_u_m_b_e_r.  Certain
  55.             versions of the IRIX kernel may also use this value when
  56.             generating array session handles.  _n_u_m_b_e_r must be a value between
  57.             0 and 32767.  It will override any IDENT setting in the LOCAL
  58.             section of any configuration file.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrrrrraaaayyyydddd((((1111mmmm))))                                                          aaaarrrrrrrraaaayyyydddd((((1111mmmm))))
  71.  
  72.  
  73.  
  74.      _----_mmmm_tttt _n_u_m_b_e_r
  75.             Sets the time interval for arrayd deamon to check whether any mpi
  76.             job has died.  If any mpi job dies arrayd will clean up the
  77.             children of that mpi job.  The time interval is in second and it
  78.             can be any number between 0 and 32767. The default time interval
  79.             is 10 (sec).
  80.  
  81.      _----_nnnn     Ordinarily, arrayd will automatically "daemonize" itself, that is,
  82.             dissociate itself from the current terminal and place itself in
  83.             the background.  Specifying this option will cause arrayd to run
  84.             in the foreground on the current terminal.  This is mostly useful
  85.             for testing purposes.
  86.  
  87.      _----_nnnn_ffff    Do not read any configuration files.  This is most useful with
  88.             options like _----_ssss_mmmm that cause _a_r_r_a_y_d to quit after performing tasks
  89.             that do not require configuration information.  _----_nnnn_ffff will override
  90.             any _----_ffff options.
  91.  
  92.      _----_nnnn_mmmm    Do not set the system machine ID.  This is used to override a
  93.             "LOCAL OPTIONS SETMACHID" statement in the configuration file.
  94.  
  95.      _----_pppp _n_u_m_b_e_r
  96.             This specifies which port the array services daemon should listen
  97.             on for requests.  It will override any PORT setting in the LOCAL
  98.             section of any configuration file.
  99.  
  100.      _----_qqqq_ffff    Quit after parsing the configuration file(s).  This is the same as
  101.             the _----_cccc option.
  102.  
  103.      _----_qqqq_mmmm    Quit after setting the system machine ID.  Causes _a_r_r_a_y_d to exit
  104.             as soon as it has set the system machine identifier (or would have
  105.             done so, in the case where this operation is not supported by the
  106.             current OS release).  This may be useful in cases where a non-
  107.             default system machine identifier is desired, but none of the
  108.             other array services provided by _a_r_r_a_y_d are needed.  This can also
  109.             be used to change the machine identifier on a system that is
  110.             already running another copy of _a_r_r_a_y_d; in this case, kernel-
  111.             generated array session handles will use the new machine
  112.             identifier while those generated by _a_r_r_a_y_d will continue to use
  113.             the original machine identifier.
  114.  
  115.      _----_ssss_mmmm    Some versions of IRIX permit setting a system "machine
  116.             identifier", which is used by the kernel for generating global
  117.             array session handles.  If the current system has this facility
  118.             and _----_ssss_mmmm is specified, _a_r_r_a_y_d will set the machine ID to the value
  119.             specified by a LOCAL IDENT statement in the configuration file or
  120.             on the command line using the _----_mmmm option.
  121.  
  122.      _----_vvvv     "Verbose": the daemon will run in the foreground (as with the -n
  123.             option) and will send any error messages, plus some additional
  124.             messages, to stderr rather than syslog.  Specifying this option
  125.             more than once or specifying more than one "v" (for example "-
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaarrrrrrrraaaayyyydddd((((1111mmmm))))                                                          aaaarrrrrrrraaaayyyydddd((((1111mmmm))))
  137.  
  138.  
  139.  
  140.             vvv") will cause additional debugging information to be generated.
  141.  
  142.      To clean up _e_r_r_o_r_l_o_g file at a specific time interval the user needs to
  143.      set two variables before running _a_r_r_a_y_d; they are AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLCCCCHHHHEEEECCCCKKKK and
  144.      AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLAAAAGGGGEEEE. The AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLCCCCHHHHEEEECCCCKKKK variable defines the interval, in
  145.      seconds, that arrayd uses to check for files in the "/tmp/.arraysvcs"
  146.      directory.  The AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLAAAAGGGGEEEE variable, also in seconds, defines the
  147.      interval that _a_r_r_a_y_d uses to check the age of the files in the
  148.      "/tmp/.arraysvcs" directory and remove files that are too old.
  149.  
  150.      The default value for AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLCCCCHHHHEEEECCCCKKKK is 3600 seconds (1hr). The default
  151.      value for AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLAAAAGGGGEEEE is 86400 seconds (24hrs).
  152.  
  153.      On larger systems with 128 processors or more, this tmp directory may not
  154.      be cleared often enough, causing permission problems with the special
  155.      files located therein.  In this case, it is recommended that lower values
  156.      for AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLCCCCHHHHEEEECCCCKKKK and AAAARRRRRRRRAAAAYYYYDDDD____EEEELLLLAAAAGGGGEEEE be used.  For example, setting these
  157.      variables to half of the default values - 1800 and 43200 respectively -
  158.      will clear this tmp directory more frequently and should resolve most
  159.      permission problems of this type.
  160.  
  161.      The system administrator can define these two variables before the call
  162.      to arrayd in the "/etc/init.d/array" script, then stop and restart
  163.      arrayd.
  164.  
  165.      If you want to run jobs through arrayd across a large cluster, where
  166.      there might be a lot of congestion on the network, you might want to tune
  167.      AAAARRRRRRRRAAAAYYYYDDDD____CCCCOOOONNNNNNNNEEEECCCCTTTTTTTTOOOO and AAAARRRRRRRRAAAAYYYYDDDD____TTTTIIIIMMMMEEEEOOOOUUUUTTTT variables. By default, these two
  168.      variables are set to 5 seconds and 45 seconds, respectively. If there is
  169.      a possible network congestion, you might want to set these two variables
  170.      higher than default setting. This might slow down some array commands
  171.      when a host is unavailable but it will help to prevent MPI start up
  172.      problems due to connection time-out.
  173.  
  174.  
  175. NNNNOOOOTTTTEEEESSSS
  176.      _a_r_r_a_y_d can be set up to run automatically at system initialization time
  177.      by using the _c_h_k_c_o_n_f_i_g(1M) command to turn on the aaaarrrrrrrraaaayyyy feature:
  178.  
  179.             _cccc_hhhh_kkkk_cccc_oooo_nnnn_ffff_iiii_gggg _aaaa_rrrr_rrrr_aaaa_yyyy _oooo_nnnn
  180.  
  181.  
  182.      When run in this manner, _a_r_r_a_y_d will take its command line options from
  183.      the file /etc/config/arrayd.options.
  184.  
  185. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  186.      array(1), arrayd.conf(4), array_services(5).
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.